package org.convallaria.system.biz.mapper;

import org.apache.ibatis.annotations.Mapper;
import org.convallaria.infrastruct.db.mapper.BaseMapperX;
import org.convallaria.system.biz.entity.SysTenant;

/**
 * 系统租户 Mapper 接口
 * 
 * 功能特性：
 * - 继承BaseMapperX，支持多表联查
 * - 支持批量操作的高性能实现
 * - 支持忽略逻辑删除的查询方法
 * - 提供统计和聚合查询方法
 * - 支持自定义SQL片段复用
 * 
 * 业务说明：
 * - 租户管理是SaaS应用的核心组件
 * - 支持多租户数据隔离
 * - 支持软删除机制
 * - 支持乐观锁并发控制
 * - 支持租户状态管理
 * - 支持租户过期时间管理
 * - 支持租户联系信息管理
 * 
 * 关联关系：
 * - 与用户表：一对多关系，通过tenant_id关联
 * - 与部门表：一对多关系，通过tenant_id关联
 * - 与角色表：一对多关系，通过tenant_id关联
 * - 与菜单表：一对多关系，通过tenant_id关联
 * - 与配置表：一对多关系，通过tenant_id关联
 * - 与字典表：一对多关系，通过tenant_id关联
 * 
 * 数据约束：
 * - tenant_name：租户名称，必填，全局唯一
 * - status：租户状态，0=正常，1=停用
 * - expire_time：过期时间，可以为空（永不过期）
 * 
 * 数据安全：
 * - 支持租户数据权限控制
 * - 支持租户状态控制（正常/停用）
 * - 支持租户名称唯一性约束
 * - 支持系统租户保护
 * 
 * @author convallaria
 * @since 1.0.0
 */
@Mapper
public interface SysTenantMapper extends BaseMapperX<SysTenant> {

}
